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(54) System and method for propagating revisions through a communications networic 



(57) A system, and method of operation, for propo- 
gating revisions through a conrvnurdcations network. 
The system includes: (1 ) status reporting circuitry, asso- 
ciated with a secorxi node of the communications net- 
work, for collecting and trarYsnrvtting a current status of 
secorxi node information stored in a memory of the sec- 
ond node, (2) first information revising circuitry, associ- 
ated with a first node of the communications network, 
for receiving the current status from the secorxi node, 
determining as a function of the cunent status wtiether 
a revision of the second node information is required 
and, if the revision is required, transmitting the revision 
to the second node to revise the secorxJ node infbrma- 



FIG, 



tion and (3) second informatfon revising drcurtry, asso- 
ciated with the second node of the communications 
network, for receiving a current status from a third node 
of the communicatfons networic, determining as a func- 
tion of the current status from the third node whether a 
revisfon of third rxxJe information stored in a memory of 
the third node is required and , if the revision is required , 
transmitting the revisfon received from the first node to 
the third node to revise the third node information, the 
revision therelsy propagating through the conrvnunica- 
tions network via the first, second and third nodes 
thereof. 
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Description 
COPYRIGHT NCmCE 

5 A portion of the disclosure of this patent document contains material which is subject to copyright protection. The 
copyright owner has no objection to the facsimile reproduction by anyone of the patent document or the patent cfisdo- 
sure. as it appears in the Patent and Trademark Office patent file or records, txrt othenwise resen^es all copyright rights 
whatsoever. 

10 TECHNICAL RELD OF THE INVENTION 

The present invention is directed. In general, to communicattons networks and, more specifically, to a system and 
method for distritxiting updates to nodes of a hierarchical communications network that cascade the updates through 
the network as a function of its hierarchy. 

15 

BACKGROUND OF THE INVENTION 

Imn^surable gains in technology offered in personal computers ("PCs') have alk>wed PCs to assume roles per- 
formed only mainframe or minicotrputers in the past. Many companies and. for that matter, individual users rely 

20 largely on commercially-availat)le PCs to meet their information processing needs. Thus. It is vital that their PCs perfonn 
reAiabfy. The fault tolerance of a given computer system is a sensitive issue with companies and individual users given 
the level of reliance th^ place on their computing systems. 

Initially PCs were stand-alone devices, each containing separate hardware, operating system, application software 
and user data. As use of PCs spread within business organizations, however, the need for shared data and hardware 

25 resources grew, and local area network f LANs") came into being. A LAN (or its more^eographically<lispersed coun- 
terpart, tiie wbe area network C*WAN*0) includes a number of PCs (''clients") linked to one another (typfoally by a high 
speed serial communications linl^ and centers around a relatively high performance PC or minicomputer ("sender") that 
delivers programs and data to the cfients and manages systerrHmde resources, such as seoorvJary storage units arvJ 
printers. 

30 The networking concept has proKfen very useful, but suffers from a couple olcfsad^ Rrst. since manage- 
ment of the network is focussed in the server, the overall performance of the network is compromised whenever the 
sender beconries a processing bottleneck. Second, smce progranris and dato 

clients, a cfistrtxition problem occurs whenever a software provkfer or vendor modifies one of hs programs or data The 
modified program or data rruist typically be cfistrftxited from the server to the cGent conputers i^ manner, often 

35 within a single business day. In a prior art solution, the server, or a liosT computer kientif led by the server, is respon- 
sUe for sequentially traversing each of the cfient conrputers supporting an *ckSr versfon of the modified program or 
data, and then updating those cfient computers as necessary to implernenfttfw'ti^ In an alternate prior art 

solutioa the server, or the host corrputer. traverses each cfiem computer, updati^ 
server^ faes. 

40 A problem inherem to the prior art solutions is thaA substantial server, or host processing re^ 

establishing a conrwnunfoation link with many, rf not all. of the client connputers. and then ifxiating the sam& Further, if 
the server Is responsible for performing the updates and the number of client connputers being sennced by the server 
increases, the overall periorinance of the network may signifkaritty be conpronr^^ 
ing bottteneck. A system and nriethod are needed lor propagating revisfons 

45 tionsnefawork wherein the cornrnunkations network, and in particular the server^ resotf 
nor wasted The inabifity of conventional sdutions to accornpGsh the foregoing renrtain^ 
software products distrft)uted among various ones of the ctiem conrputers of a CO 

SUMMARY OF THE INVENTION 

50 

To address the above-discussed defk;ienctes of the pria art the present invention provkf es a system, and method 
of operation, fa propagating revisk)ns throu^ a commurecations networic, wherein the communications networic 
includes a plurality of associated nodes. 

The system includes: (1 ) status reporting circuitry, associated with a second node of the communications network. 
55 for collecting and transinitting a current status of second node inforrnations^ (2) 
first Infbnnation revising circuitry, associated with a first node of the communications networic, for receiving the current 
status from the second node, determining as a function of the cunent status whether a revisfon of the second node 
information is required and. if the revision is required, transmitting the revision to the second node to revise ttie second 
node infbnnation and (3) second information revising drcuitry. associated with the second node of the communications 
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network, for receiving a current status from a third node of the communications network, determining as a function of 
the current status from the third node whether a revision of third node information stored in a memory of the third node 
is required and. if the revision is required, transmitting the re/ision received from the first node to the third node to revise 
the third node information, the revision thereby propagating through the communicatfons nrtwork via the first second 
5 and third nodes thereof. 

The present invention therefore allows revisfons to propagate automatically through a communications network. 
Nodes in the network are responsit)le for twth detecting when a revision to information in another node is necessary 
and transmitting the revision to the other node. 'Information," as used the term is used herein, is defined txoadly to 
enconpass tx>th instructions {e.g., programs, functions, tasks, subroutines, procedures and the like) and data. The] 



10 Informatfon" subject to revision by the present invention may, for example, be a conrputer program (alfowing automatics 
dislrtoution of program updates, fixes, tools and the like), computer data (ep.. documents, spreadsheets, databases, 
data faes and the like). vkJeo data or the lika 

In one embodiment of the present invention, at least the second information revising circuitry includes memory for 
storing a subscrO^er list, wherein the second infornDation revising circuitry transmits the above-descn'bed revision as a 

15 function of the content of the sitecrfoer list The present invention is therefore able to form the core of a fee-t>ased 
update service, wherein subscribers pay for revisions. The amount of information revised and the frequency of the revi- 
sfons may be selectable, alfowing a range of fee-based servfoes to be offered. In a related enrtxxiiment, the subscriber 
list and the current status are suitably processed to identify a subset of the information of the subscriber list that is avail- 
at)le to a particular user or group of users, the processing therefore functioning as a filter for the subscnlser list. 

20 In one embodiment of the present invention, the status reporting drcurtry collects and transmits the current status 
of the secorxJ node information to the first node at a first time, status information circuitry associated with the third node 
coOecting and transmitting the current status from ttie ttiird node to the second node at a second time, tiie second time 
sut>sequent to the first time by a penod of time suffk^ient to allow the second node information to be fully revised before 
the second information revising ctrcurtry transmits the revision to the tiiird node. This allows orderly "waves" of revisions 

25 to propagate through the network. Alternatively, revisions may t>e dstributed in a nrxx-e random fashion, as one node 
determines that another requires a revisfon. 

In one embodiment of the present invention, the second information revising circuitry is embodied in a sequence of 
instructions operable on a second processor associated with the second node, the revisfon capable of including revi- 
sfons to the sequence of instructions, ttiereby alfowing an operation of the second information revising circuitry to be 

30 inocfified or altered. The tnfornrtation revising droiitryilseH /f 
The oomnrunfoations network is hiGrarchical,^in one enrto 
as a sen^ for the second node, the second node functions as a server for the third noda "Hie 
used herein, means a structure of many levels wherein particular levels have control or precedence over other levels 
(e.g.. higher precedence levels over tower precedence levels), and wherein a first level node may be hierarchtoally 

35 related to one or more second level nodes, each second level node may be Nerarchfoally related to one or more thirci 
level nodes, each third level node may be hierarchk:ally related to one or more fburtti level nodes, ete. Precedence may 
suitably be based upon order {e.g. sequentially), responsfoilrty. fonctionafity. etc. The broad scope of tiie present inven^^ 
tion ttierefore encompasses tree-based networks, as well as flat, peer-to-peer networks. The present invention is fur- 
thermore not Gmrted to computer networks, such as LANs or WANs, but rattier is operable in telecommunfoatfon 

40 systerns to update system software or data or in wireless erivironments. such as ceD^ 
networks. 

In one embodiment of the present invention, the first information revising drcuitoy includes first security drcuitry for 
authenticating the ainrent status receh^ from the second node before the first no^ 
ond node and the second node includes second securfty draitry for authenticating ^ 

45 node before revismg the second node irTformaUon. fo a retatedembo di ii^ 

the revision on a f3e-by4ieb^is. Of oxxrse. the security drcurtry ma^ allowing 
the drcurtry to change or t>e ipdated over time. 

In one embodiment of the present invention, the first information revising drcuitry revises the second node informa- 
tion by fogging onto tiie second node and transniitting a sequence of conriniand^ 

50 ond node to receive tiie revisfon. The present invention ttierefore operates in a conventional network environment and 
may ttierefore be completely transparent to ttie underlying network operating system ("NOS"). Security and ottier fea- 
tures of ttie NOS may therefore remain intact 

An advantageous embodiment for using and/or distributing ttie present invention is as software The software 
embodinrtent includes a pforality of instructions whfoh are stored to a su^ 

55 storage mecSum. The instructions are readable and executabte by one or more network nodes having processing dr- 
cuitry. The instructions, upon execution, direct the processing drcuitry to propagate revisfons through a communk;a- 
tions network wherein ttie communfoations network indudes a plurality of associated nodes in accordance witti ttie 
present invention. B®mplary memory and storage media include wittiout limitation magnetic optical, and semiconduc- 
tor, as well as suitat)ly arranged combinations thereof. 
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The foregoing has outlined, rather broadly, preferred and altemative features of the present invention so that those 
skilled in the art may better understand the detailed description of the invention that follows. Additional features of the 
Invention will be descnl>ed hereinafter that form the subject of the daims of the invention. TTiose skilled in the art should 
appreciate tfiat ttiey can readily use the disdosed conception and spedfk; embodiment as a basis for designing or mod- 
5 ifying other structures for carrying out the same purposes of the present invention. Those skilled in the art shouM also 
realize that such equivalent constructions do not depart from the spirit and scope of the invention in its broadest form. 

BRIEF DESCRIPTION OF THE DRAWINGS 

10 For a more complete understancGng of the present invention, reference is new made to the following descriptions 
taken in conjunction with the accompanying drawings, in which like numbers designate like parts, and in which: 

FIGURE 1 illustrates a tkxk diagram of a conventional hierarchical communications network in which the principles 
of the present invention may advantageously be implemented; 
75 FIGURE 2 illustrates an isometric view of an exemplary processing system node chat provides a suitable environ- 
ment within which the present invention may be implemented and operated in accordance with the communications 
network of FIGURE 1; 

FIGURE 3 illustrates a high-level block diagram of an exemplary microprocessing drcuit that may suitably be asso- 
ciated with the processing system of FIGURE 1 and that provkies a suitable environment within which the present 
20 invention may be implemented and operated; 

FIGURE 4 illustrates a high-level bkxk cfiagram of a single exemplary branch of the communications network of 
FIGURE 1; and 

FIGURE 5 illustrates a ikw diagram of an exemplary metfKxi of operatk>n for propagating revisions through the 
communications network of FIGURE 1 in accordance with the prindples of the present invention. 

26 

DETAILED DESCRIPTION 

Referring initially to FIGURE 1, illustrated is a bk>ck diagram of a conventk)nal hierarchk:al communteations net- 
wori^ a computer networic (generally designated 100), in whk:h the principles of the present inventkm nray advanta- 
30 geously be implemented. Exemplary network 100 includes a server node 110 and a plurality of conventkxial dient 
nodes 120a-120c. 130a-130f and 140a-140h. "Indude; as the temn is used herein, is defined as indusion without Imrv 
Habon. A Iriode,' as the term is used herein, is defined as any pnctioa statkm, terminal or the 

like, whether portable or not, that is capable of convnunk;ating signals, or infbrmatioa within communk;atk>ns network 
100. 

35 Server node 110 may suitably and conventk)nally be sharable fcy dient nodes 120a-120c. 130a-130f and 140a- 
140h. Sender node 110 and dient nodes 120a-120c 130a-130f and 140a-140h may suitably be associated with one 
another, either directly or indirectly, by any cor^/entional means, viduding communication links, portal devk^es (eg., 
routers, bridges, gateways, switches, etc.) or the Ite "Associated with," as the term is used herein, means to indude 
within, interconnect with, contain, be contained within, connect to, couple with, t>e communicat)le with, juxtapose, coop- 

40 erate with, interleave or the IBqsl "Or," as the term is used herein, is ondusive, meaning and/or. 

TheiDustratedassodationof nodes 110, 120a-120c 130a-130f and 140a-140hsuitat)(yfadlitates resource sharing 
as well as the balandng of resoun:e requests aniong ones of the nodes, technxiues that ar^ 
nkaaton among various ones of the nodes nwy suitably indude the transrn is sCT 
nrunicatksn si^tal may suitably be cfivkled irttD pack^ 

45 a physk^al quantity for conveyng inlbrmatk)n. A typical signal may suitably include a cdection of related data items, 
such as (fiscrete data, address or instnKrtion obiects th^ 
onesof ttienodesw 

In an advantageous embodiment, as will be d scussed in greater detail with reference to FIGURES 4 and 5, revi- 
sk)ns to at least a portk>n of the informatbn stored on server 1 10 niay suitably 

50 through communicatk>ns network 100 in accordance with the princq^les of the present invention. *'Revisk)ns; as the 
terni is used herein, means changes. modiffcatk)ns, additions. deletk)ns, acyuslments, alterations. variatk>ns, customi- 
zations. and the like. More partx:ularty, at least one of the second level nodes 120a-120c collects and transmits a sec- 
ond level currem status of inrforrnatk)n stored in the one or nrme secondly nodes. The second level cunrent status of 
irrfonmation may suitably be for the entire level or for indivkiual ones of second level nodes 120a-120a Server 110, a 

55 first teve! node, receives the second level current status of informatwn anddetenmines, as a functk>n of the second level 
current status of informatXHi.wfiether a revision of one or nrK>re of the secorKi level nodes' information is required. If ttie 
revision is required, sen^ 1 1 0 transmits the revisbn of the second level node information to the one or more second 
level nodes 120a-120c. 

After the revision, the one a more second level nodes 120a-120c may suitably receive a third level cunrent status 
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of information from at least one third level node 130a-130f. and detennine. as a function of the third level cunent static 
of information, whether a revision of the one or more third level nodes' information is required. The third level cun-ent 
status of information may similarly be for the entire level or for individual ones of third level nodes 130a-130f. If the third 
level revision is required, the one or more second level nodes 120a-120c transmit at least part of the revision received 
5 from server 1 10 to the one or more third level nodes 130a-130f to thereby revise the third level node information. 

An irrportant aspect of the abwe-identified and ^Jescribed embodiment is the breadlh4irst-type, or Ian-out" 
update. More particularly, revisions to the first level node infonnation are suitably propagated through ones of the sec- 
ond level nodes, then the third level nodes, and so on, such that the revisions to the first level node information may be 
propagated through communications network 100 in an exponential manner. 
10 Turning to FIGURE 2, illustrated is an isometric view of an exemplary processing system, a PC (generally desig- 
nated 200). Processing system 200 is capatile of functioning as any node 110, 120a-120c, 130a-130f and 140a-140h 
within exemplary communications n^work 100. Processing system 200 suitably includes a chassis 205, a display 
device 210 and a keyboard 215. Chassis 205 includes a hard disk drive 220 and a floppy disk drive 225. Roppy disk 
drive 225 may suitably be replaced by or combined with other conventional structures for transferring data or instruc- 
ts tions, including tape and compact disc drives, telephony systems and devices (including telephone, video phone, fac- 
simile or the tike), network communication ports and the like. 

Chassis 205 is partially cut-away to illustrate a battery 230. a dock 235. a detached local memory 240 and process- 
ing drcuitry 245 ("CPU'O. all of which are suitably housed thereia Detached local memory 240 is operative to store data 
arxi instructions. The stored instructions may suitably be grouped into sets of tasks, including programs, procedures, 
20 subroutines, functions, and the like. Processing drcuitry 245, which is assodated with detached k>cal memory 240, is 
operative to execute selected ones of the instructions stored therein to propagate rev^ns to the stored data and 
instructions through communk:ations network 100 in accordance with the principles of the present invention. 

In an advantageous embodiment, display device 210 is operative to provkie a d^play area 250 that is accessible 
to executed ones of the plurality of instructions, and that is capable of displaying a graphical user interface. Furtiier cou- 
25 pled through individual conventional connectors (not shown) on chassis 205 are a mouse 255 and a printer 260. Exem- 
plary peripheral devk^ 210, 215, 255 and 260, all of whk^h are associated with processing drcuitry 245, allow 
processing system 200 to interact with a user. Exemplary peripheral devices 210, 215. 255 and 260 may suitably be 
replaced by or cont)ined wfth other conventional user interfaces. 

AmK>ugh procesdng system 200 is illustrated having a single processor, a a 
30 nnernory, processing system 200 nn^ suitably be equipped wHh any multi^ 
devk^esw Pnnessing system 200 rn^. in pdm of fact be replaced by. o^ 
accordance with the prindples of the present bwentiori, tndi^^ 

book, mini, mainframe and super computers, telephony systems (e.g., sound, vkJeo, data, etc.), message paging sys- 
tems, portal devices and the like, as wen as network combinatk>ns of the same. 

35 Conventional processing system architecture is more fully discussed in Computer Org anization and Architecture. 
by WiUiam Stallings. MacMiUan Publishing Ca (3rd ed. 1993); conventional processing system network design is more 
fully discussed in Data Network Desion. by Darren L Spohn McGraw+lill. Ina (1993); and conventional data conrvnu- 
nfcations is more fully cfiscussed in Data Conmirecations Principles, by R. D. Qtlin. J. F. Hayes and S. a Weinstein, 
Plenum Press (1992) and in The tnwin Handbook of Telecommunications, by James Hanry C^een, Irwin Professk>nal 

40 Publishing (2nd ed. 1992). Each of the foregoing puUk^tions is incorporated herein by reference. 

Timing to FIGURE 3, illustrated is a ht^i4evel bkx:k diagram of an exemplary rruonoprocessing drcuit (generally 
designated 300) that may suitably be associated witti a processing system, such as PC 200 of FIGURE 2. Micro- 
processing droit 300 includes detached kscsA memory 240. processing drcuitry 245. bus controller drcuitry 305. a 
corwentional read-only rnernory (TOiO 310 and a set of peripheral ports 31& A 

45 operative to associate processing drontry 245. detached kx^alrnenrnry 240 arxlb^ InacoonJ- 
ance with the Blustrated errbocBment. detached iocaU memory 240 may suAaMy include random access memory 
(T^AM*). and processing ctrcurtry 245 may suitably mlude one or more processors actirtg in coricert 

An input/output {VOT) bus 325 is shown and is operative to associate bus controller drcuitry 305. ROM 310 and 
the set of peripheral ports 315. The set of peripheral ports 315 may suitably couple I/O bus 325 to peripheral devices 

50 210, 215, 255, and 260 of FIGURE 2 for communk»tion ttierewrth. Induded among the set of peripheral ports 315 may 
suitably be a serial or a parallel port Bus controOer drcuitry 305 provkies suitable means by whk:h host bus 320 and 
I/O bus 325 may t>e assodated, thereby prcvicfing a path and management for corrminKation theret>etween. In accord- 
ance with the illustrated embodiment, host bus 320 is relatively fast to fadlitate rapki communk:ation between process- 
ing drcuitry 245 and detached local memory 240 and is typically burdened witti as few components as poss&Ae to 

55 maximize its speed. I/O bus 325 is alkMved to run at a slower pace witti respect to host bus 320 because its speed is 
less critical. Each of ttie lines of the buses 320. 325 require a drive current to carry signals ttiereon. Accordingly, the 
present invention operates in cor^unction witti a conventional system controller (not shown) that supplies the required 
drive current. Of course, the present invention may also suitably function within an architecture that only has a single 
bus. 
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In attemate preferred entodiments, microprocessing circurt 300, in whole or in part nnay be replaced by. or com- 
bined with, any other suitable processing circuitry, including prograrrvnable logic devices, such as programmable array 
logic CPALsT and programmable logic anays (TLAs"), digital signal processors ("DSPs^, field progranunable gate 
arrays ("FPGAsl, application specific integrated circuits ("ASICs'O, very large scale integrated drcuils fVLSIs") or the 

5 like, to form the various types of circuitry descnbed and dainr^ herein. 

Turning momentarily to FIGURE 4. illustrated is a Ngh-level block diagram of a single exemplary branch (generally 
designated 400), or a collapsed hierarchy, of communications network 1 00 of FIGURE 1 . Exemplary server 1 1 0 and cli- 
ent nodes 120a and 130a form a hierarchical comntinications path wherein the illustrated nodes are suitably associ- 
ated via conventional communication links 405 and 410. respectively. FIGURE 4 is presented for the purposes of 

10 illustration in connection witii the discussion of FIGURE 5 only Although the illustrated embodiment focuses upon a 
tree-based hierarchical network, those of ordinary skill in the art will realize that the principles of the present invention 
are applicable in any suitably arranged communications networking environment {e.g., peer-to-peer networks, etc.). 
The present invention provides a means by which revisions to information associated with one or nrK>re first level nodes 
may suitably be communicated to one or more second level nodes, from at least one of the one or more second level 

IS nodes to one or more third nodes, from at least one of the one or more third level nodes to one or vme fourth nodes, 
etc. The present invention ttierefbre facilitates the propagation of revisions through a convnunications network at an 
exponential rata 

Turning to FIGURE 5. illustrated is a flow diagram of an exemplary method of operation of communications network 
100 for propagating revisions through branch 400 of FIGURE 4, and more particularly, server 1 10 and client nodes 

20 120a and 130a. in accordance with the present invention. The present discussion is undertaken with reference to FIG- 
URE 4, and it is assumed that each of exemplary nodes 1 10, 120a and 130a includes a suitable processing means, 
such as micraprocesstng circuit 300 of FIGURE 3 or other suitable implementation capable of providing equivalent func- 
tionality An exemplary source code embocfiment is attached hereto as APPENDIX A and is incorporated herein by ref- 
erence for all purposes. The exemplary embodiment is written in conventional Kbm Shell code for use with a UNIX 

25 environment. System V Release 4 ("SVR41. 

For purposes of discussion, it is further assunted that server node 110 receives revisions to information stored in a 
memory associated therewith. The revisions may suitably t>e received from any of a number of sources, including soft- 
ware providers^endors. for exampte. 

The illustrative process begins when dient node 120a scans its associated menr^ 

30 thereon (e.g.. files, database, data configurations, programs, routines, subroutines, functions, tasks, and the like) and 
generates a status report (process step 500). The status report represents the current status of client node 120a infor- 
mation, arxJ may suitably include an klentifier to identify various dient node inlbrmatioa a version number associated 
with various cGent node information, a revision date associated with various dient node information, or the like. The 
scanning process may suitably be initiated extemaUy by server node 110 or internally by dient node 120a. In either sit- 

35 uation. the initiation may suitably be performed periodk;ally or aperiodically 

Client node 120a. possibly using one of peripheral ports 315. transmits the status report to sender node 110 
(inputADutput step 505). Sen^ node 1 10, possiiiy udng one ol its peripheral 

report and suitably verges the acoiracy of the transmission (process step 510). Techniques for verifying the transnvs- 
sion of data are krwwn. 

40 In an advantageous embocfment. sender node 110 is further operative to autiienticate the current status of dient 
node 120a by togging onto dient node 120a, and confirming the tntbrmation within the received status report "Authen- 
ticate,* as tiie term is used herein, means to establish the auttientidty of. prove genuine or the like, induding confinm, 
conroborate. priM^ substantiate, vafidate. verify, or the lika Fw 
ent node 120a includes version 1.0 of software padoge XYZ, server 1 10 rnay sui^^ 

45 firm that ctient node 120a in fed includes version 1.0 of software package XYZ.O^ such 
as software padrage XYZ. indudes a plurality of files. In a related enrtxxlin^ 
status report on a fOety^e basis. 

Server node 110. if ttie status report was correcdy received, determines as a function of the received status report 
whether a revision of dient node 120a stored information is required (dedsional step 515). In another advantageous 

so embodiment, a suitable inventory is maintained, eittier directfy or indirectiy, by server node 1 1 0. The inventory indudes 
a list of the infonmation maintained, used, provided, or the like by server node 1 10. and posst)ly dient node 120a. The 
determination of whether dient node 120a stored information requires revision is suitably performed by comparing the 
status report with the inventory thereby identifying information that (1 ) is missing from client node 1 20a. (2) may suitably 
be removed from dient node 120a. (3)^ not a recent version, (4) is expired, such as under ttie terms of a license ag^ee- 

55 ment. or ttie like. Conventional techniques for performing corrparisons are knowa 

In connection witti licensing arrangements, ttte above-referenced identifk^tion process may suitatsly be used to 
klentify valid, invalid, out-of-date or ttie Bke subscriber infonmation maintained by dient node 120a, an aspect of ttie 
present invention ttiat is discussed in greater detail hereinbelow. 

If dient node 120a stored information requires revision (YES branch of decisional block 515), server node 110 surt- 
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ably creates an irrfbrmation revision file for transmission to dient node 120a (process step 520). An exemplary informa- 
tion rev^ion fSe may suitably include programs, functions, tasks, subroutines, procedures, documents, spreadsheets. 
datat>ases. data files, data configurations, or the Kke. The rension file may also suitably include a set off instructions for 
execution by dient node 1 20a. the executed set off instructions may suitably cfirect dient node 1 20a to install the remain- 

5 der off the inffbrmation revision f fle, perfonm transmission verifications, security or the like. 

Server node 1 10. possft)ly using one off peripheral ports 315. suitably transmits the reviston file to client node 120a 
(input/output step 525). Client node 1 20a. again possibly using one off its peripheral ports 315. receives the transmitted 
revisions file and verifies the accuracy of the transmission (process step 530). Iff the transmission was correctly 
received, the stored inffbrmation on dient node 120a is updated using the received revision file (process step 535). 

10 The ffbregoing update may suitably be performed in any one of a number off ways, for example, server node 110 
may suitably update dient node 120a stored information by logging onto dient node 120a and one off: 

(a) perform the update in a conventional "master-slave"-type environment (/.e., communications session in which 
one side, called the master, initiates and control the sessfon. and the other side, called the slave, responds to the 

IS master's commands), and 

(b) transmit a sequence of commands to dient node 120a that upon execution by dient node 120a. enable dient 
node 120a to perform the update. 

In another example, dient node 120a receives the revisfon file from server 1 10. bufffers the received revision file, and 

20 suitably performs ttie update. Client node 1 20a may also receive ttie above-kientified set of instructions as part off the 
revision fQe. the set of instructions, when suitably executed t>y dient node 120a. direct dient node 120a to install the 
remainder off the buffered revision file, or alternatively, to perfbrm transmissfon verifications, security or the like. 

In accordance with the iHustrated embodiment, dient node 120a, a second level dient in network branch 400. may 
suitably function as a temporary ""server* to dient node 130a. a third level dient in network branch 400. 

25 The illustrative process continues wh^ dient node 130a scans its associated memory studying the information 
stored thereon (e.^.. files, datat>ase. data configurations, programs, routines, subroutines, functions, tasks, and the like) 
and generates a status report (process step 540). The status report represents the current status off dient node 130a 
information, and may suitably indude an kientifier tojd^jtiffyjvanous^ version number assod- 

ated with varkxis dient node infornriatiori^^isim Tbe 

30 scanning process may suitably be initiated exterriaDy by dient node 120a or Enters 
uation, the initiation nri^ again suitably be perfonrned perk)dk;any or aperfo^ 

Qient node 130a, possftily using one off peripheral ports 315. transmits the status report to dient node 120a 
fmput/output step 545). Cliem node 120a, possUy using one off its peripheral ports 315. receives the transn^ 
report and suitably verifies the accuracy off the transmissfon (process step 550). 

35 In an advantageous embodiment, dient node 1 20a is further operative to authenticate ttie cunrent status of dient 
node 130a by fogging onto dient node 130a. and conffinning the inffbrmation within the received status report. In a 
related entxxtinrient. the autheritication of tfie status report, portioris off wtiich may again indude a pluralrty off fles. is 
perffbrmed on a file43y^e basis. 

Clientnode 120a, if the status report was correctty received, determines as a function of ttie received status report 

40 whether a revisfon of dient node 1 30a stored infonmation is required (dedsfonal step 555). In yet another advantageous 
embodiment, a suitable inventory is maintained, eittier directly or indrectty. by cfient node 120a. The inventory indudes 
a list off ttte information maintained, used, provkJed. or ttie like by dient node 120a. and possS)ly dient node 130a or 
sen^ node 1 1 0. The determination off whettier cSent node 1 30a stored information requires revisfon is suitably per- 
formed by cornparing ttie status report witti ttie nventory ttiereby kl^^ 

45 node 130a. (2) rnay suitably be removed from cliem node 130a, ^) is no^ 
the terms off a Bcense agreement, or ttie fika 

In connection witti Ifoensing arrangements, ttie above-relerenced dentiffoation process may suitably be used to 
dentify valki. invalki. out-off-date or the fike subscrtt>er information maintained by dient node 130a. an aspect off ttie 
present invention ttiat is discussed in greater detail hereinbefow. 

50 Iff dient node 1 30a stored infbmnation requires revision (YES branch off dectsfonal block 555), dient node 1 20a suit- 
ably creates an infbrmation revisfon ffle for transmissfon to client node 130a (process step 560). The information revi- 
sfon fHe may suitably indude. at least in part, ttie revision file received by dient node 120a from server node 110. 

An exemplary information revisfon fOe may suitably indude programs, functions, tasks, subroutines, procedures, 
documents, spreadsheets, databases, data ffles, data configurations, or ttie lika The revisfon file may also suitably 

55 indude a set off instructions fbr execution by dient node 130a. ttie executed set off instructions may suitably direct dient 
node 130a to install the remainder off the information revision fine, perform transnrussfon veriffoations, security or the 
like. 

aient node 120a. possfoly using one of peripheral ports 315. suitably transmits ttie revision fHe to dient node 130a 
(input/output step 565). Client node 130a, again possibly using one of its peripheral ports 315. receives ttie to-ansmitted 
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revisions file and verifies the accuracy of the trartsniission (process step 570). tf the transmission was correctly 
receivecl, the stored information on client node 130a is updated using the received revision file (process step 575). 

The foregoing update may suitably be performed in any one of a number of ways, for example, dient node 120a 
may suitably update client node 130a stored information by logging onto client node 130a and one of: 

5 

(a) perfbnn the update in a conventional "master-slave'-type environment (/.e. , communications session in which 
one side, called the master, initiates and controls the session, and the other side, called the slave, responds to the 
master's commands), arxJ 

(b) transmit a sequence of commands to client node 130a that upon execution by client node 130a. enat)le client 
10 node 130a to perform the update. 

In another example, client node 130a receives the revision file from dient node 120a. buffers the received revision file, 
and suitat)ly performs the update. Client rKxie 1 30a may also receive the atxve-identrf ied set of instructions as part of 
the revision fie, the s^ of instructions, when suitably executed by dient node 130a, direct dient node 130a to install the 
15 remainder of the buffered revision fine, or alternative, to perform transmission verifications, security or the like. 

The atxTve-identified and -described process may suitat)ly be perfomned in a conventional network environment 
and may further suitably be transparent to the underlying network operating system f NOS"). This featu-e enable con- 
ventional security and other features of the NOS to remain intact. 

An important aspect of various embodimerrts of the present invention, is that either dient node 120a or 130a may 
20 suitably indude a sequence of instructions for performing at least a portion of the atxiv&described update process 
which itself is subject to an update by the received information rev^ionfie. The sequence of instructions may suitably 
t>e revised by the received revision file, and then suitably executed, thereby alkwving one or nme operations of one of 
dient node 1 20a or 130a to be modified ard altowed to change or be updated over tima 

Another important aspect of the present invention as exemplified by the illustrated embodiment, is that dient node 
25 130a staed infomnation may suitably be revised, at least in part, by ttie revision file received by dient node 120a from 
server node 1 10. The revision ttiereby propagates through the communications n^work via the first second and third 
nodes thereof. 

In a related ent>odment the stalus report generated by dient node 120a may be transnr^^ 120a 
to sender node 1 10 at a first time, whereas the status report generated by dient node 130a may then be transnvtted 
30 from dient node 130a to dient node 120a at a second time. The second time may advant^eously t>e subsequent to 
the fvst tirne by a period cf time sufficient to alk)w cfient node 120a in^ 

120a transnwts the reirision to dient node 130a. A further aspect of the present invention thereiore is alkMvance of 
orderly Graves" of revisk)ns to propagate through communications network 100. In alternate embodiments, reinsions 
m^ suitably be distrSxjted in a more random fashk>n, as one node determines that anotfier node requires a revision. 

35 An advantageous application of the present invention is to subGcrft}er-based software distribution systems. *Sub- 
scriber-based systems," as ttte phrase is used herein, means electronk: communications systems wherein a party, tiie 
"Subscriber." contracts with a vendor, distributor, licensor or the like to receive and pay for a certain number of issues, 
verskxts,athe likeof a particular software package, gmup of software packages, electronk; sennces, or the lika More 
particulariy. at least one of server node 1 1 0 or dient node 1 20a includes memory for storing a sut>scriber list, assodat- 

40 ing subscribers with their subscribed to services. Server node 1 10 and dient node 120a transmit revision fSes, at least 
in part, as a function of the content of the subscriber 6st The present invention therefore may suitably form the core of 
a fee4>ased update servk;e, wherein sufc>scribers pay for revisk>n& The amount of infonration revised and the fre- 
quency ol the revisions nriay be selectable, alkiwing a ran^ 

ment the subscriber Bst is assooated with a rcs trc ted ist The restricted ist, when suftaMy processed in association 
45 wHh the subscriber tist klentifies a subset of the in fbrmatpn of the subscriber list ttiat is available or unavaBable to a 
particular user or group of users, such as a group of users associated by geographkal kx»tion, far eocampla The 
restricted list may therefore furictioris as a f9ter for the subscriber Bst 

The propa^tion of updates through a sut>scrft>er-based systems may be particularly advantageous, not only over 
WAMs. such as the Internet, txit also through cMe television systems, such as those provkfing pay-per-view and 
50 demand-telev^on. including emerging services for receiving vkieo games and other interactive servk;es. 

Rom the atxyve, it is apparent that the present invention provides a system, and method of operation, for prepar- 
ing revisions through a communk:ations networK wherein the commurucations network irKdudes a plurality of assod- 
ated nodes. The system indudes: (1) status reporting drcuitry, assodated with a second node of the communrcations 
network, for cdlecting and transmitting a current status of second node information stored in a memory of the second 
56 node, (2) first information revising drcuitry, associated with a first node of the communications networic, for receiving the 
current status from the second node, determining as a function of the current status whether a revisbn of the secorvl 
node infonmation is required and, if the revision is required, transmitting the revisfon to the second node to revise the 
second node information and (3) second information revising circuitry, associated with the second node of the commu- 
nications network, for receivirig a current status from a third node of the communications network, determining as a 
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function of the current status from the third rxxie whether a revision of third node information stored in a merTX>ry off the 
third node is required and. iff the revision is required, transmitting the re^sion received from the first node to the third 
node to revise the third node information, the revision thereby propagating through the communications network via the 
first, second and third nodes thereof. Revisions are therefore allowed to propagate automatically through a communi- 
cations networK wherein various nodes within the comirumications network are responsible for both detecting when a 
revision to information in another node is necessary and transmitting the revisk)n to the other node. 

The broad scope of the present invention is not limited to tree-based hierarchical networks off the type set forth in 
FIGURES 1, 4 and 5, txjt also includes other conventional networks configurations, such as peer-to^er conrununica- 
tions networks. The propagation of revisions is also not limited to a first node to a second node to a third node progres- 
ston, but rather includes revisbn of afirst node propagated to one or rTX>re second nodes, from at feast one of the one 
or more second nodes to one or more third nodes, from at least one of the one or more third nodes to one or nwe fourth 
nodes, etc., thereby enabling not only the sequential revision of serially associated nodes, but also a hierarchical fan- 
out updating of a plurality off nodes. 

The present invention is also not limited to pure tomputer-tiased' communtoations networks, such as LANs or 
WATsIs, but may also suitably be inrpleiDented in telecommunication systems to update system software or data or in 
wireless environments, such as cellular telephony or message paging networks. To that end. the principles of the 
present inventk>n may suitably be associated with any network element functioning as a node, inducting routers, 
bridges, gateways, switches, or other conventfonal portal devices, satellites, relay stations, or the like. While the princi- 
ples of the present invention have been described in detail, those skilled in the art should understand that they can 
make varkMJS changes, substitutions and alterations herein without departing from the spirit and scope off the invention 
in its broadest form 
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CMD= ' tasename SO* 

USAGE- 'Usage: SCNCD [ -d ] [ -s serverlD )* 

KSHOK-DO 

echo yes | read KSHOK 

if test -SKSHOK* - "no'; tbcn 

if test •S{RETRYING^KSH:-iio}- - -yes"; then 

echo 'SCMD: ERROR: not ninning wim kshSS - aborting!' 

echo '$CMD: ERROR: noc runniiig widi kshSS *- abortsng!* | 

/bin/mail expcools 

RC-2 
e!iftestS#-gtO: dieii 

RETRYING_KSH-"yc$- SSHEIX SO 

RC-S7 

else 

RETRYING^KSH-"yes* SSHELLSO 
RC-S? 

fl 

exit SRC 

fl 



4f < emsg 

tf This routine prints out error messages and mails them to cxptoots 
emsgO{ 

typeset MSG-*SCMD: ERROR: SI - akiortiQg!* 

typeset LOG-SAl»^UG/SSERVERID/locaJ/sciidplist.out 

typeset ECODE ECMD 

if test -n 'S2*; dien 

echo S2 I read ECMD ECODE 

MSG»*$MSG\ttError *SECODE' reported tyy SBCMD** 

n 

ecbo'SMSC* >&2 
{ 

echo "Subject: sendpltst error!* 
echo 

echo'SMSG* 

if test -s SLOG; dken 

echo *\iiHcfc is the com p lctr seadpHst log fUe:' 

echo * ' 

pr-o4-tSLOC 

echo* • 

n 

) I /bio/mail exptoob 



$ < extractsection 

9 

0 This routine exiiscts given sectiots of input (tics that are terminated by 
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» (he EOF line. 

extractsectionO { 
imegcr scctioii«*Sl 
typeset inputfUe«$2 
integer i=l 

typeset UNE done- fiUse 

while not $done read UNE: do 
ir((t > section)): then 

done— true 
clif test -SUNE* - -SEOr; tfjcn 

((i +« D) 
clif ((i • « section)); then 

echo 'SUNE* 

n 

done < Sinputflle 

} 



ff < iDain 



GEIDPT«$(getoptd$: 
ir((S?!»0)):dien 

echo "SUSAGE" 

exit 2 

n 

set - SGETOPT 

jtrset -c 9 Exit on any error 

debug»'* 
SERVERID=" 
for arg in 'S®*; do 
case *Saig* in 

-s) 

SERVERID^S2 
shift 2 

^) 

debug-: 
shift 

-) 

shift 
break 

csac 
done 

if test ! -f lADMRUG/gk^config: then 
emsg -Can t find RUG global config file' 

exit! 

fi 

. SADMRliG/global/config 

if test -n -SSERVERID'; then 
FOUND^false 
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for tD in SSERVERIDUST: do 

if test 'SID" = -SSERVERID"; then 
FOUND-tnie 

fi 

done 

if not SFOUND; then 

emsg "Unknown scrvertd 'SSERVERID* given* 
exit 2 

fi 
else 

if tcsi -2 "SDEFAULTSERVERID*; then 
emsg 'DefuiU server id missing" 
exit 2 

n 

SERVEIUD=SDEFAULTSERVERID 

ft 

exec > SADNfRUG/SSERVERlD/locai/sendplist.out2>J^l 
ccbo "Start *datc'\n" 

CA5CAOEFILE»SADMRUG/SSERVERID/global/cascade 
if test -f SCASCADEFILE; then 

cp SCASCADEFILE SADMRUG/lOGal/cascadefile 

chmod 664 SADMRUG/Iocal/cascadcfUe 

n 

. SADMRUG/globaininkconfig SSERVERID 

NETINFO»${echo ISERVERID STYPE | SNETCMD) 
if test -z "SNETINFO": then 

emsg "Unable to acquire oetworic infonnatiott" 

cxit2 

n 

echo 'Nciworkijig information: SNETINPO* 

tmppkglist=>/usr/tmp/SSplcglisi 

tmpplist^/osr/tmp/SSplist 

tmpexclude^/usr/tmp/SSexclude 

tropignorc»/usr/tmp/SSigDore 

mJqpcrrs » Aisr/tmp/SSmkperrs 

crrfilc = /usr/imp/SSerrfilc 

cmpsttbrile»/usr/tmp/SSsubfile 

tn9flist=:='Stmppkgiist Stroppltst Stmpexclude Stmpignore Smkpcrrs Serrfile StmpsubfUe" 

rctval«0 
trap * 

retval=l 

exit 
• 1 2 3 15 
trap * 

rm "t Stmpflist 

exitSretval 
EXIT 

cd 

rm -f adm/upd I . I /lih/cpio. new » Remove emergency update list 

echo *\nComputing the subscription list ..." 
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echo The SLOGNANfE uscnd uses tbe alias *$LOCALCLIENTID* to subscribe to the 
follomng STYPE tools from SSERVERID*:* 

cat SSUBSCRLIST | f Combine HU* subscr-lat fiki 

deanComm | 

sea 7**/d' I 

son -f > Stmpsttbfile 

if test -s Strapsubfile; then 

pr -04 H -4 Stmpsubfile 

else 

echo "NONE!- 

n 

catSSUBSCRUSTI # Combiae W subscr-ltst files 

CtcanComm | 

sed -n^'J/d; s/*!//' | 

son -f > Stmpsubfile 

if test -s Stm^ubfUe; then 

echo ' rejecting these tooto:* 

pr -04 H -4 Scmpsubftle 

n 

} > SADMRUG/local/subscriist 
chmod 664 SADMRUG/local/subsctitst 

echo *\nConiputing checksums...* 

( 

> Senfile 

> Smkperrs 
( 

catSEXCLUDEUST # Combine •aU* cxchide-tist files 

genlinkdirs SSERVERID 
} I fflkscd > > StmpigDOce 

{ find . ! -name V* -print 1 1 echo "find S?* >Scrrfik :} | 

{ scd -e *s!n./!!' -rStmpignofe 1 1 echo "scd ST' >$enfUe :} | 

{ STADMRUG/bm/mfcplist nn 2> Smkpcns 1 1 

echo *al[pKttST* >$enfile ;) | 
{sort-u II ccfao'sortST* >$crrfiie;) 

if test -s Serrfilr. then 

if test -s Smkperrs; then 
cat Snkperrs > > SADMRUG/SSERVERID/local/sendpltstout 

fi 

ern^ 'Futorc preparing client plisc report" *S(< SerrfOe)* 
exit 2 

else 

echo -SBOr 

fi 

) > Stmpplist 
chmod 664 Stmpphst 

eva) S{dcbtg: -i-'cp Simpptist SAI»^UG/SSERVEIUD*} 

ir((S(TZ»<Mrd8»>«H) < 2»: thca #irbcfbrt2AM(»IT 
mtegjcrWAITTIME-RANDOMXiaOO # sci t/2 hour random delay 

echo *\oWaiting SWAirriME seconds ID prevent server C¥crload* 
sleep SWAITTIME 

fi 

echo *\nScndiqg to SSERVERID' 
echo • JNETINFO' | 

Sdebog SSENDCMD -u SSERVERID.LOGNAME -f ije/SSERVERID/SLOCALCUENTID.SYRDAY Stmpplist 
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> Scrrfile 

cat SSUBSCRliST | ft Combine *aU* subscr-list files 

CteanComni | 
sort -u 

ccho*$EOF 
{ 

cat SEXCLUDEUST » Combine *&U* exdude-ttst files 

genlinkdirs SSERVERID 

}| 

CteanComm | 
sort -u 

ecbo-SEOP 

If (est z 'SDEFALTLTLOCAUD'; tbea 

echo *0:SljOCALCUENTID:$(uiiame -D):SLOGNAME:S(uname -rvm)" 

else 

typeset UNKDIR-SADMRUO/SDEFAULIXOCAUD 
typeset RJE-SHOME/rje/SDEFAULTUXAUD 

echo *0:5LOCALCLZENTID/SDEFAi;LTLjOCALZD:${itmme -n):SLOGNAME.$(uname -cvra)* 
if test -r SUNKDIR/server/exptib; ttiea 

sort SUNKDIR/scrver/exptab 
fil 

while IFS-: read CLIENT REST: do 
If test -f SR/E/SCUENT.pkg: dieii 
integer COUNT-0 

exiractsectioo 3 SRJE/$CUENT.pkg | 
while IFS- : read COUNT CT ND UID OS: do 
((COUNT +- I)) 

echo -SCOUNTtSCTiSNDrSUIDtSOS- 
done 

fi 

done 

fi 

ccbo"$EOF" 
) > SinppkgUst 
chmod 664 Simppfc^m 

eval ${debtig:+'cp Snnpplcglist SADMRUG/SSERVERID*} 
echo 'SNETINFO* | 

Sdcbttg SSENDCMD hi SSERVERID^LOGNAME -f fje/SSERVERID/SLOCALCUENnD.pkg Stmppkglist 

iff-sSmkpcm]; then 
{ 

echo 'Sttbiecc mkpUst errors on SLOCALCUENnDVn' 
scd 'sr/SLOCALCUENTIDrsendpliscSTYPE:/- Smkpens 

)l 

/bm/mail SSERVERMAIL 

f Log die error mesagcs 
echo ^Errors:* 
caiSmkpens 



rm-r/tmp/shSS.l 
echo 'XoFim^ 'date'" 
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"SENDUPPT" SniJRrF rODE 



CMD - ^ basenamc SO^ 

USAGE= "Usage: SCMD [ -cdprR ] [ -I locallD ] ( -i threshold ) client* 

KSHOK"no 

echo yes | read KSHOK 

iftcsc 'SKSHOK' - "do"; then 

if test •${RErRYING_KSH:-no}" » "yes"; then 

echo 'SCNfD: ERROR: Not running with lcsb88 - aborting!' 
RC=2 
clif tcsc&tr-gtO; then 

RETRYING_KSH="yes" SSHELLSO "Si©" 
RC-$? 

else 

RETRYING KSH-'yes* SSHELLSO 
RC=$? 

fi 

exit SRC 

fi 

alias -X echo» "print 



ff < emsg 

if 

tt This routine priius out error messages and mails them to cxptools 
cmsgO{ 

typeset MSG»-SCMD: ERROR: SI - aborting!- 
typeset LOG<»$outfile 
typeset ECODE ECMD 

if test -n 'S2*: then 

echo S2 I read ECMD ECODE 

N4SG=-SMSG\n£rror SBCODE* reported by SECMD " 

fi 

echo 'SMSG' >&2 
{ 

echo "Subject: sendupdatcs error!' 
echo 

echo 'SMSG* 

if test -s SLOG; dten 

echo "\nHere is the cad of the sendupdatc log file:' 

echo" ' 

taUSLOG I pr-o4-t 

ecoo ~ '■ ■ ■ ■ ' ■ 

n 

} I /bin/maiJ exptoob 

} 



< findclient 

if This routine returns a list of machines of die type defmed by the first arg 
nndclientQ { 
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macfaiiie$iype<-"Sl | sort 

} 



# < ciranupcltent 

0 Tbis routmc removes old ije files for a dfStgiMtrri diem. 

clcsnupcltemO { 

typeset CUENTID»S1 today-S2 
typeset rmpancra todayfilc 

Ustyr»>*exprSyr • V 

S{debug} nn -rSIUE/SCIJEKnD.${lastyr}« SRJE/SCUENTID.difr* 
rmpanem-'SRJE/SCUENTID S{yr}*' 
todftyfUe- 'SRlE/SCUENnD-Scodiy* 
for X in Snnpanem: do 

If test -Sx' !- -Stodayfile' -» 'Sx* !- -Snnptiieni*; tben 
${debug} nn Sx 

fi 

done 



0 < ddetefiles 

25 0 This commsnd deletes files from a client 

ddctefUesO { 

Sdebug dctfUc -v SEXPPKGID -c P SEXPPWD -M SSERVERMAIL 'S^* name^ -SCUENTID 

) 

30 



f 

f 

0 This cowmsnd d e l etes directones from a client 
deletedirsO { 

35 Sdebug irmdir ^ -p SEXPPKGID -c -P SEXPPWD Salmid *M SSERVERMAIL name- -SCUEhTTID 

) 

0 < nddeffiles 

0 

^ 0 Tbis routine sends die commands to ddde files from a client 

senddetfilesO { 

typeset CLIENTn>«*Sl dtfTik^Sl 

typeset pasefB-"^- \( *rO^>S' ^ ocdiaaty (iKMHtir) tDe paneni 

^ if((S(grcp-c*$paneni*$difllle) >g»:diea 

echo "XtRemofve files:* 
scd -n *s!SpancnU \l!p' Sdiffile 

sed -n *s!$paiicm!nn M*!p' SdiflUe | 
{ 

I Do the staodard setup 

echo HOME- expr : •H.*^V«<»ni/bin/- ' 
echo *. SHOMEZ-cronprofUe' 
0 Now get the user commands 
cat 



55 
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) > Stmpcrodnie 

rex -cv -p SEXPPKGID -r priv -P SEXPPWD Saltuul -M SSERVERMAIL -f StmpcmdfUe name- -SCUENTID 



0 < scndchmods 

f 

# This routine sends dunod commands to a ctient 

sendchmodsO { 
typeset CUENTTD-Sl Uimie-SI 
typeset pmcrn-'n([MJ*\)\(.*\)$' # cbmods file ptnera 

ir(( S(grep < 'Spanern* Sdiflite) > 0)). then 
^5 echo ^XtCbange files:' 

sed -n *s!$paitern! V 1 \2\p* SdifTUe 

sed -tt 's!Spaaern!chmod M 'V2'*p' SdifTOe | 

{ 

# Do tbe standard setup 

echo HOME- expr "SO* . -XC.nVadm/bin/- • 
20 echo SHOME/.cronprofile* 

f Now get tte user commands 
cat 

} > SinqicmdfUe 

rex -cv -p SEXPPKGID -r pnv -P SEXPPWD Saliutd -M SSERVERMAIL -f Stmpcmdfile name- -SCUENTID 

ri 

25 ) 



$ < acudi i iud iia 

# 

30 sendrmdirsO ( 

typeset CUENTID-Sl diffile-S2 

typeset paiierB*"'-\(.*\VS' # lUrectory pasen 

if (( S(grcp -c 'Spanern* SdifTUe) > 0». then 
echo *\tRemove directory: ' 
35 sed -tt 's'Spaitem! \1 *p' SdifTUe 

sed -n *s!Spattcm!-d*\r !p' SdifTUe | 
sort-r I 

xargs -S350 echo dcktcdirs I # echo the function wc want 

eval *S(cat)' B exec coastiticsed fbnction 

Ti 

40 I 



50 



55 



0 < sendrcpfiles 

sendrcpfilcsO { 

typeset CUENTID-Sl diffOe-Sl 

integer oneineg-104S576 f number of bytes in a one meg ftk 
integer tmzB # number of bytes in a Uock on this 

integer limit f tiMXimum size of cpio fOe m blocks 

typeset CPIOFLAGS # flags for cpio 

case S(inachtype) 

in ftrni) bsize»4096 » ibm uses 4096-byte blocks 

pyr) bsize-2048 # pyr uses 2048-bytc blocks 
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;; *) bsizc<=S12 if everyone else uses 512-byte blodcs 

esac 

((HmiE B oncmeg / bstzc)) if calculare tbe block size timic of Tiles 
5 sed -n '5!+ \(.*(*/l\y/*\$!'M'!p- SdifTile > Stmpdtsc 

if [ -s 'Stmpctist* ); tbcn 
integer sum bO size 
echo "Vt Update files:* 
scd 's/V r Stmpclist 

> Stmpwlist 
10 xargs Is -sd < Stmpclist | 

{ 

CPIOFLAGS='-oc' 
if rest "STYP* 'mip"; then 
CPIO«expcpio 

else 

CPIO»cpiD 
ifSSVR4: then 

CPIOFLACS--K> -Hodc- 

n 

fl 

while read -r size filename; do 
({sura = sum + size)) 
^ if [[ Ssum -gi Slimit &A, -s Stmpwlist )]; then 

SCnO SCPIOFLAGS < Stmpwlist > Stmpcpio 

Sdebug sendcpio -v -p SEXPPKGID -c -P SEXPPWD Saltutd -M SSERVERMAU. -f Stmpcpio 

namc»*$CUENTID 

((sum = size)) 
> Stmpwlist 

25 fi 

echo *SrilcDame' > > Stmpwlist 

done 

SCPtO SCPIOFIAGS < Stmpwlist > Stmpcpio 

Sdebug semfepto -v SEXPPKGID -c -P SEXPFWD Saltuid -M SSERVERMAIL -f Stmpcpio name= =$CUENTID 

30 ^' 
) 

if < dirlog 

if 

^ dirlogO { 

typeset CUENTlD»$t difrUe-S2 

sed -n •A/$/s%\(.*\).%'daie +%y»ro%d* \l%p' Sdifftle > > SLINKDUVclient/SCUEhfTID/dirlog 
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if < updlog 

it 



{ 

typeset CLIE^^^D»S I diffile^S2 

scd -o -A/y>s%"% date +%y%ffl%d^ Hp* SdifTile > > SUNKDDVcfieat/SCUENTIDAipdlog 

) 



it < piistOK 

it 
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typeset pUstfile* SI 
typeset RC 

iftest!-r'SplisifUe':ibeQ 
ftC-1 

clif test *$(tait *l SplistTtle Z>/dev/nttU)* *- *SEOF*; then 
RC«1 

else 

RC-0 

fl 

return SRC 

} 



n < pkgflteOK 

# 

pkgTileOKOf 

typeset pkigTUe^Sl 
typeset RC 

if test i-fSplcgfUe''; then 
RC-1 

eliftest 'S(Citl -1 SpkgfUe 2>/<lev/aull)'' !- "S£OP*; men 
RC-1 

else 

RC:«0 

fl 

remrnSRC 

> 



nr < mkiDotfist 

# 

$ This rooune returns a full Kst of the tools subs cr ibed to in the file 
9 given as argiuneoL 

mlaooUistO{ 
typeset RC 

> ScTTfUel # begin with no error condition 

> StmpsubscrZ # begin with no tool list imtiaUy 
for subfile, do 

# etiminue coounenis and bSaok lines 

{ flrairf^oimn < SsubfUc 1 1 echo *CkaflComm S?* >Serrfilt2 ;} | 
9 get cxe hid cd tool names 

{ scd iTl/r 1 1 echo *scd Sr >ScrrfSle2 ;) j 

9 expand any Tf*^**n*H**T 

(cxpandtoob 11 ectao'cxpandtooIsS?* >Serrfik2 .} | 
#sort the list 

{sort -a >StnpexctiHle||echo*sortS7' >Serrtile2;) 
if test -5 SerrfUel: then break: fl # Break out of loop on error 
9 move previous tool list 

( Riv Stnipsubscr2 Stmpsubacrl 1 1 echo *mv $7* >$crrfile2 ,} 
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if test -s SerrfileZ: then brealc: fi If Break out of loop on error 
If eliminftte conunems and blaidc lines 

{ ClcanComm < Ssubfile 1 1 ecbo 'CleanComm $?' >Serrfite2 ;} { 

ff get subscribed tool names 

{ sed 'r!/d* 1 1 echo "scd $?* >$crrfUc2 :) | 

# expand any metanames 

{ expandtools 1 1 echo "expandtools S?' >Senri]e2 ;} | 
U add previous tools and sort them 
{ sort -u - Stmpsubscrl 1 1 ecbo *sort S?* > Scrrfilc2 :} | 
i remove the excluded names 

{ comm -23 - Stmpcxclude > Stmpsubscr2 1 1 echo '*comm $?' > $crrfile2 :} 

if test •s$errfilc2; then brealc; ft # Brealc out of loop on error 
done 

if test -s Serrrile2: then 

read ECNfD ECODE < $crrfite2 

echo "SO: Error SECODE' reported by SECMD" >.&2 

RC=$ECODE 

else 

cat Stnipsubscr2 ff return the final list 

RC=0 

n 

return SRC 



tf : < extractseccion 

If 

9 This routine extracts given sections of input files that are tcnniittted by 
if Che EOF line. 

cxtracssccttooO { 
integer s ect i on =S1 
typeset tnpntfile:3S2 
integer i»l 

typeset LINE done* false 

while not Sdone read LINE; do 
if (0 > section)): then 

done»trttc 
clif test "SUNK" » •$EOF'; then 

(0 0) 
clif ((i section)); then 
ccho*$UNE' 

ft 

done < Sinptttfile 

} 



9 < mailncws 

mailncwsQ { 

typeset NEWSTIM£=SHOME/.mailnews_timc NEWSDIR»SADMRUG/news 

if test ^ SNEWSDIR -a -n "$*"; then 
cd SNEWSDIR 
for flic in £(ls -tr); do 

if test Sfile -nt SNEWSTIME; then 
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ccbo *\cAnnouocaieitt 'SHtc* mailed to S** 
{ 

ccbo 'Subject: Exptoots aanouncemenr 
echo 

} I /bttt/m&iJ S* 



done 
cd- 

fl 

touch SNEWSTIME 

) 



-< salutation 



saluiationO { 
75 if not SSALUTATION: then 

SALUTATION-troe 
e 



ecbo * — > To ibc Exptools Admimstnuor of server SLOCALID:' 

fi 



# < cltemsort 

0 

if This routixie sorts clteats based oa the depth and number of macfaine in the 
2g 9 cascade dicy serve. This allows clients who have deeper and more numerous 

c a s ca d es to get their tools first and begin serving them sooner. 

clicnisortO { 
typeset CL 

imcgcr DEPTH MAXDEPTH N4ACHCOUNT WEIGHT 

forCU do 

30 typeset l>KCFnX»SHOME/iie/SUX:AUIV$CL.plcg 

N4AXDEFni»0 MACHCOUhTT-O WEIGHT »0 
if test -rSPKCFILE; then 
eioractscction 3 SPKGFILE ) 
while IFS-: read DEPTH REST: do 

if ((MAXDEPTH < DEPTH)); dien 
35 ((MAXDEPTH - DEPTH)) 

ft 

if ((DEPTH !)); then 
((MACHCOUNT ^l-^ I)) 

fi 

done 

((WEIGHT MAXDEPTH + MACHCOUNT/4)) 

40 fi 

echo'SWeCHTSCL- 

done I 

sort +0-lnr 4-1 | 
while read DEPTH CU do 
ccbo*SCL- 

45 done 
} 
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autoload lake 
cd 

GETOPT-$(gctopicdprIU:t: "$©•) 
if((S?!-iO)):tbcn 

echo -SUSAGE* 

exit 2 

n 

set -SGETOPT 

debugs" 

LOCAUD-- 

RESEND-filsc 

CHECKSUMS-fBlsr 

USEPUST-bte 

NULL MEANS.ALL-tnie 

${TimESHOLD:-200} 
for arg in do 

cue *Strg* in 

<) 

CHECKSUMS»cruc 
shift 

^) 

debug^ccho 
shift 

-r) 

RESEND-tnic 
NULLJ4EANS ALL-fUse 
shift 

i> 

RESEND»tnie 
shift 

i) 

USEPUST-true 
shift 

•• 
-I) 

THRESH0LD-S2 
shift Z 

-I) 

L0CAUD-S2 
shift 2 

-) 

shift 

DTCIK 

CSftC 

done 

CUENTUST-'$®* 

if test > -r SADMRUG/globU/config; dieti 
echo -SCMD: ERROR: Caa't find RUG global conTig file- 
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exit 2 

fi 

. SADMRUG/global/config 

if test -n "SLOCAUD*; then 
FOUND= false 

for ID io SDEFAULTLOCALID SLOCAUDUST; do 
if test -SID" - "SLOCAUD*; then 
FOUND^true 

n 

done 

if not SFOUND; then 

echo 'SCMD: ERROR: Unknown local server ID 'SLOCALID' given - aborting!' 
exit 2 

n 

else 

if test -z "SDEFAULTLOCALID*; then 

echo *SCMD: ERROR: Default local server ID missing - aborting!* 
exit 2 

n 

LOCAUD=$DEFAULTLOCAUD 

ft 

. SADMRUG/global/linlcconfig SLOCAUD 

oucnie » SUNKDIR/seiver/update. out 

if test S(fiDd SoutTile -mame + 1 -print | wc -I) -oe 0; then 

SENDUPDATES DORMANT=tnic # Scndupdaces has been asleep! 

else 

SENDUPDATES DORMANT^ false 4r Sendupdates running as usual 

fi 

Sdcbug eval 'exec > Soutrae2>&r 
echo *Start 'datc'Vn* 

EXFTAB^SUNKDIR/scrver/expiab export EXPTAB 

EXPPKGID^SLOCAUD 

RJE=SHOM£/rie/SLOCAUD 

NEWFILES»SHOME/adm/upd 1 . l/tib/cpio.new 

NEWFILESCOPY=SHOME/adin/updl. l/llb/cpio.ncw2 

: ${tinp:s/usr/tinp} 

tmpCignorc=$tinp/SSCignofe # List of files to ignore from Client 

tmpSignorc^Stmp/SSSigttore 0 List of files to ignore from Server 
(mpignrile=Stinp/SSignrile U Woric file of files to ignore 
tmpdiff =Stinp/S$pdi^ $ List of files to change on client 

tmpclistsStmp/SScUst U Ust of files to cpio to client 

tmpplist=Stmp/S$plisi U Sorted, uncommcnted client ptist 

tinpwlist=Stnip/SSwlist U List of files It size limit to cpio 

i]npcpio=Stiiq>/S$cpio 9 Cpio file to send to client 

tmp^cdude^Stmp/SScxcl if Work list ofcxrhidcd tools 

impsubscrl =Stmpi/$$SDbl U Work list of subscribed took 

tmpsubscr2= Slmp/llsab2 If Work list of subscribed tools 

iropCNTmodel=Stmp/SSCmodel f Karnes of fiks desired by diem 
tmpCNTplist»$tmp^S$CpUst U Client plist with excluded files removed 
tnipSRVtools»Stmp/SSStools 9 List of toob offered 
tmpSRVplist=Stmp/SSSplist 9 Plist of files offered to client 
tmppkgfilenStnip/SSpkgfile 9 Woric file of packages client subscribes to 
tmpfilesBStrop/SSfiles U Work file of file names 

tmpcmdfile=Strop/SScmds 9 Work file for commands to be sem 

crrfite^Stmp/SScrrfilc 9 Flag file for detecting errors in pipes 
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eiTfilc2 = Stmp/SSerrfilc # Flag file for detecting errors in p^>cs 

trapnist='StmpCignorc StmpSignorc Stmpignfile Sunpdiff Stmpclisi Stmpplist Sirapwlist Stnjpcpio StmpcxcJude StmpCr^modcl 
SimpCNTplist StmpSRVtools StmpSRVplist Simppkgmc Stmpnics Slmpcmdfiie Stmpsubscrl Stmpsubscr2 Scrrfile Scrrfile2" 

retval=0 
crap ' 

recval^l 

eut 

trap * 

trap - ERR 

emsg 'Error code Srccval detected" 
exit Sretval 
ERR 
tr^ * ■ 

SdetHig nn -f Stmpflist 
{ 

echo "Subject: SLOCAUD gateway runlog\n* 
cat Soutfile 

}| 

Sdebug /bin/mail SADMIN_EMAtL 
exit Sretval 
EXIT 

if SSENDUPDATES_DORKfANT: iben 

echo *«*********»*«*«**«*»«»«*««*****«****«****«****••***«**- 

echo 'WARNING: Scodupdatcs has not been run for over 4S bours'Xa" 
echo **««**************«**«*«**«**«***«*******•**«****««*«»*««• 

fi 

SRVplist=$LINKDIR/scrvcr/plist.$yRDAY 
SRVnisc»$UNKDIR/scrver/nist 
for rUc in SUNKDIR/scrvcr/plist.*; do 
if [ •Sfile- *$SRVpli5C- ); then 
nn 'f SfUe 

n 

done 

if test -2 •SCUENTUST" ASt SNULL_MEANS_ALL; dicn 
CUENTUST« * fiodclicQt STYPE^ 

fi 

echo 'Clients: 
SCUENTUSr 

ifSR£5END;then 

for CUENTID in SCUENTUST; do 

CUENTID=$(talcc 8 SCUENTID) 

EXPPWD»SUNKDIR/cJiemA$CUENTID/.pwd 

if test -s SUNKDIR/diem/SCUENTID/uidnamc: tbcn 

altutd»*-u$(< SUNKDIR/dtent/SCUENTID/uidnaroe)" 
else 
attuid» 

n 

tmpdifr»SRlE/SCUENTID.difr 

SaSPENDED-SUNKDOUcHcnt/SCUENTID/Sitspcndcd 
if test ! -rStmpdift tbcn 

echo '\n— > No dtlT file found for SCUENTIDVa* 
elif test -f (SUSPENDED SNUIX.M£ANS_AU^ then 

echo '\n~> Client SCUENTID cuirently suspended' 
else 
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cc-*wc-l < StmpdifT 
ifl-$cc*-€q01;ihcii 

echo *\nVtNo updates for SCUENTID* 

else 

cclio *\a\taiaiigcs for SCUENTID: * $cc 
seoddesroes SCUENTID StmpdifT 
sendrrmdirs SCUEKHD StmpdifT 
sendcbmods SCUENTID StmpdifT 
sendrcpfiles SCUEfTTlD StmpdifT 
dirlog SCUENTID StmpdifT 
updlog SCUENTID StmpdifT 

ft 

fi 

done 

elif SUSEPUST 1 1 SCHECKSUMS 1 1 mitplisiOK SSRVplist; dten 
{ 

catSEXCLUDEUST 

genUiricdin SLOCAUD 
} [ mksed -w > StmpStgnore 
if SUSEPUST; (bea 

eclio 'VnAcceptiog cunent chcdcsumi 

else 

echo *\oCreaiiQg upwird cascade map* 

UPDLOG -STOOLS/adm/upd 1 . 1/libAipdiog 

CPI0UX}*ST0OLS/admAipdl.l/ltb/^io.log 

TZ-$OU> TZdaie | read X X X X TIMEZONE REST 

MONTH-'DATE* 

DAY-'UNKNOWN!- 

TIME-" 

If tcst^SCPtOLOG -a! -f SADMRUG/.ovcr. diea 

TZ-SOU>_TZIs-lSCP[OUXS | read X X X X X MONTH DA Y TIME REST 

TIME«'ST1ME ST1MEZ0NE* 
ctif test *r SUPDU30: then 

T2-SOU)jr2lH$UPDUX5 | read X X X X X MONTH DA Y TIME REST 

T1ME»*STIME STIMEZDNE* 

n 

integer LEVEL 

CASCADEFILE«SUNKDm/glot»al/Gascade 
echo -l:SLOCAUD:SMONTH SDAY STIME" > SCASCADEFILE 
Tor ID to SDEFAULTSERVERID SSERVERIDUST; do 
if test -f SADMRUG/SID/glObal/cascadr, dien 

while IFS-: read LEVEL SERVER TTMESTAMP: do 
((LEVEL +- D) 

echo 'SLEVEUSSERVERtSnMESTAMP* 
done < SADMRUQ/SID/glotal/cascade > > SCASCADEFILE 

fl 

done 

cbmod 664 SCASCADEFILE 
cat SCASCADEFILE 

echo *\oCccatmg downwaid cascade nap* 

I 

echo "XaNQTE: Tbis cascade map gcoctaied S(date)* 
sbowtrce-ISLOCALID 
} > SUNKDIR/local/cascadc 

echo *\oChcc)cing on exptools announcements* 

( 

L0CAL_ADMIN.EMAIL« SADMIN.EMAIL 
if test -o^'SDEFAULTSERVERID*; ttoi 

. SADMRLKi/global/littlccoafig SDEFAULTSERVERID 
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SERVER ADMIN EMAIL=SADMIN EMAIL 

else 

SERVER ADMIN EMAIL-'" 

fi 

if test •$LOCAL_ADMIN_EMAn.- != "SSERVER ADMIN EMAIL": (hen 
mailncws SLOCAL ADMIN EMAIL 

fi 

) 

echo "\iiCalcuUttxig new checksums 

rm -r SRJEarpdateStarted SRJE/UpdatcEoded SR/E/RequcstEmted SerrrUe 

mktoollist SSUBSCRUST 1 1 echo 'mlctooUisi $?" >Scrrnic 
} > StmpSRVtools 

if test -s Serrftlc: then 

cmsg 'Failure preparing server cpol list' "$( < Scrrfile)* 
rm -f StmpSRVtools 
exit 2 

n 

if test ! -s StmpSRVtools: then 

echo "SCMD: ERROR: No tools being served by this server - aborting!" 
exit 2 

if not fgrep -x updtools StmpSRVtools >/dcv/nutJ 1>SlU then 

echo 'SCMD: ERROR: Essential tool 'updtools' not being served -- aborting!" 
exit 2 

n 

{ 

# Get filenames for tools served 

{ TOOLS^^SHOMESTOOLS/admAipdl.l/bin/prpkg -ir < StmpSRVtools 1 1 

echo -prpkg %?' >Scrrrile ;} | 

# Put in sorted order 

{son-u II echo 'sorts?- >Serrfilc;) | 

P Add directories to complete list 

{ STADMRUC/bin/dirfillout | ( echo •dirfiUout S?* > Scrrfile ; } | 

Remove server-ignored files 
{ scd -f StmpSigDore 1 1 echo "sed S?" >Scrrfile :) \ 
U Get plist data for given files 

{ time STADMRUG/bin/mlqplist -m 1 1 echo "mkplistS?* >Serrft)e ;} | 
U Put in sorted order 

II echo "sorts?" >$crrfile;} 

echo "SEOF" 
} > SSRVplist 

if test -s Serrfile: then 

cmsg "Faihire prqwring server checksums" "•$( < Scrrfile)" 
exit 2 

n 

fi 

if not plisiOIC SSRVpltst; then 

echo "SCMD: ERROR: Corrupted plist file 'SSRVplist' - aborting!" 
exit 2 

fi 

rm -f SNEWFILES n Remove previous list of new files 

if not SUSEPUST; then 

> SRJE/UpdateStarted 
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OVERTHRESH0LD=false 
LONGTERMPROB-faise 
MISSINGREPORT- false 
SUBSCRIBE,ERROR-false 
^ echo '\nCttrreat update chresbold: STHRESHOLO* 

ccbo *\n'nic clicttts below are processed according to the sizes of tbctr cascades,* 
echo 'largest fvsL' 

for CUENTID to $(clientsort SCLDENTUST); do 
CUErmD=${taJce 8 SCUEimD) 
ckanupdiem SCUENTID SYRDAY 
10 $USPENDED==$UNKDIR/cltcnt/SCLIENTID/Suspcodcd 
if test -r SSUSPENDED: then 

ecfao > Client SCUENTID currently suspended' 
else 

EXPPWD-SUNKDtR/clieni/SCLIENTID/.pwd 
if test -s SUNKDtR/cliem/SCUENTID/uidnanie: then 
15 altuids"-uS(< SUNKDIR/clicot/SCUENTID/uidnanie)' 

else 

altuid" 

n 

CNTplist«$RJE/$CLIENTID.SYRDAY 
CNTplcgfile-SRJE/SCUENTID.picg 
2Q if not piisiOK SCNTpiist; dken 

if test ! -f SCNTpltsc then 
MISSlNGR£PORT»true 

echo 'Xn— > No plist file found for $CLIENTID\a" 

integer DAYSOLD»0 

if test ! -f SCNTpkgnic: then 

echo • No package fOe found for SCUENTID' 
elif not SSENDUPDATES_DORMANT && test -i •S(find SCNTpIcgfile -mtime -3 -prim 2>/dcv/nulI)-; then 

DAYSOU)-4 

whUc tcst.-n •$(rind SCNTpIcgfile -mtime +$DAYSOU) -print 2>/dev/nuU)"; do 

((DAYSOU) +- I)) 
done 

((DAYSOU> -= I)) 

30 echo- Tbb client hasn't reported for SDAYSOU) days!* 

if ((DAYSOU> !- 0)); men 

ADMINDATA- SUNKDIR/ctient/SCUENTID/admiDdaia 
if test -f SAZ^ONDATA; then 
typeset NAME EMAIL 
35 while read FIELD VALUE; do 

case "SFIELD* 

in NAME) NAME»'SVALUE' 
;; EMAIL) EMAIL- -SVALUE' 

csac 

done < SADMINDATA 
40 if II "SEMAIL* ®(none|NONE| ") ]]; then 

{ 

echo 'Subject: exptoots errors' 
echo 

if 11 *SNAME- !- 0<Doi>e|NOKE|") ]}; then 
ecbonroSNAME:* 
^ echo 

fi 

echo *Tbc RUG update code has detected an error. Your client 'SCUENTID' has not* 
echo 'reported to Its server 'SLOCALID* for the btttSDAYSOLD days. Pleasechedc' 
echo *your system to see what is causing ibis prohlem. Consult the 'rugadm' HELP' 
echo 'suhsyiem for advice. The rugcbedc' command may also be helpM' 
^ echo 'in tdcntifyiog the cause of this problem.* 

echo 
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echo '\t\t\tMSLOCAUD ExptooU update routine* 
} I maUSEMAIL 

ccbo* WanungooQceseiictoSEMAlL.* 

5 

echo* No admmistnlDr email address on file for 'SCUENTID'.* 

echo ' WamiQg notice NOT SENT to that macbine' j ExptocJs administrator. * 

fi 

fi 

tf ((DAYSOLD%5 - - 0)); dten 
10 { 

echo "Subject: expioolf client trouble' 
echo 

echo The RUG update code has detected an error. The client 'SC UENTID' has not" 
ccbo 'reponed to its server *SLOCAUD' for die last SDA YSOLD days. Please contact* 
echo 'die exptools administrator of that system to see what might be causing this' 
IS echo 'problem. Vou can consult die 'rogadm' HELP subsystem for advice. ' 

echo 

echo 'MUmtSLOCAUD Exptools update routine* 
} I mail SAOMIN.EMAIL 
echo* Wamittg notice sent to SADMIN EMAIL.' 

20 n 
fi 

else 

ccbo *\ii— > Corrupted plist file found for SCUENTHha* 

fi 

eJif not pIcgfileOK SCNTpkgfile: then 
^ irtesi» -f$CNTplcgfile;dien 

MISSWCRHPORT-troe 

echo *\n— > No padcage file found for SCUENTIDVa* 
else 

echo *\n— > Corrupted package fUe found for SCUENTIDW 

fi 

else 

echo 'Wroccssing SCUENTID *daie^" 
sleep 10 # Allow odter pr o ccssta to be cleaned op 

> Scrrfile 

If test ■ -rStmpSRVtools: dien 
{ 

mlctoollist SSUBSCRLIST 1 1 echo 'mktoollist $?* > Serrfile 
) > StmpSRVtools 

if test *s SerrTile; dica 

emsg 'Faihire preparing server tool Usf *S(< SenfUe)* 
rm -f StmpSRVtDols 
cxit2 

fi 
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if test ! -s StmpSRVtools; Oen 

echo 'SCMD: ERROR: No toob bemg sewed by diis server - aborting!' 

exit! 

fi 

ifnocfgrcp-xupdtootsSimpSRVtDols >Alev/noll 2>AI, dten 

echo 'SCMD: ERROR: Essen&al tool 'updtools' not being served - aborting! * 
exitZ 

fi 

50 fi 

cxtractsection 1 SCNTpkgfile > StmppkgfUe 
exiiBctsectioo 2 SCNTpkgfiJe | 
oiksed > Stn^ignore 
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if test ! -a Stmpplcgnic; then 

echo "SCMD: ERROR: No tools being requested by this client - skipping'" 
SUBSCRIBE_ERROR-tnic ^' 
continue 

fi 

if not fgrep -x updtoob Stmpptcgftle >/dcv/nuII 2>&1; then 
echo "SCMD: ERROR: Essential tool 'updtooto' not requested - skippina'' 
SUBSCRIBE_ERROR=>tnie --ff-^ 
continue 

n 

I 

if Get tools subscribed to 

{ mlctoonist Stmppkgfite 1 1 echo "mlctoollist $?- >$enfile ;) | 
0 Intersect widi offered toots 

{ coram -12 - StmpSRVtoob 1 1 echo •coram $?" >$crrfile ;} | 
^ Get fllenames 

{ TOOLS»$HOME $TOOLS/adm/updLl/bin/prpfcg -ir 1 1 

echo -prplcg $?■ >Scrrnie :} I 

Put in sorted order 

{sort-u II echo "sorts?" >Scrrrile;n 

0 Add missing dirs to list 

{ STADMRUG/bin/dirftllout | j echo "dirnjlout $?" >$cnfile :) \ 
if Remove client-ignored rUes 

{ sed -f StmpCignore 1 1 echo "scdS?" >$errnie :} | 

if Put in plist form w/o csums 

{ STADMRUG/bin/rnkplist -c 1 1 echo "mkplist $?" >$errfile :} | 
# Put in sorted order 

{sort-u II echo "sort $?• >Serrflte:} | 

{ /usr/bin/join -j I -t' ' - SSRVplist 1 1 

echo "join $?" > SerrfiJe ; J 

} > StmpCNTmodel 

if test -s ScrrfUe; then 

emsg "Failure analyziiig cliciit SCUENTID checksums* *S( < Serrfile)* 
continue 

n 

if test ! -s StmpCNTmodel: dten 
echo "SCMD: ERROR: No files betQg requested by this diem - skiDointt»" 
SUBSCRIBE_ERROR»inie * 
continue 

n 

ClcanComm < SCNTpUsr j 4^ Clean out any comments 

sort -u > StmppUst if Make sure the file is sorted 

cut-n Sirapptist I # Get the diem filenames 

sed -f StmpSigttore | # Remofvc server-ignored files 

/usr/btn/ioin -j 1 -t* * -StmppUst > SinpCNTplist 

STADMRUG/btn^difli>list -m StmpCNTmodd s StmpCNTpIisi > StmpdifT 

PROBFILE=SRJE/.prob.SCLIENTID 

cc-*wc-l < StmpdifT 

if fgrep -X -e "- .profife* Stmpdiff >/dcv/DuU 2>&1: then 

echo "SCMD: ERROR: Update requests for this diem corrupted - skippina'* 
clif[ "Sec- -gtSTHRESHOLD): then 

echo "M > Too many updates for SCUENTID: Sec - skipping\a* 

if test -f SPROBFILE; then 

if test -z -SCfmd SPROBFILE -miime -3 -print 2>/dev/nuM)'; then 
integer DAYSOU>°4 
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while test -n -S(nnd SPROBFILE -mtimc +SDA YSOLD -print 2 > /dcv/nulJ)*- do 
((DAYSOLD +=»!)) 

done 

((DAYSOLD -= D) 

if ((DAYSOLD > 7)): then 

LONGTERMPR0B» true 

STARS- *•** " 

else 

STARS-"- 

fl 

echo S{STARS}This clicni has been over threshold for SDAYSOLD days'* 

else 

> SPROBFILE 
OVERTHRESHOLD = true 

fi 

clif [ -Sec- ^01; dicn 
nn -f SPROBFILE 

echo '\tNo updates for SCUENTID' 
else 

nn-f SPROBFILE 

echo "XtChanges for SCUENTID: ' Sec 
settddeinies SCUENTID StmpdifT 
sendmndtrs SCUEhrTTD Stmpdiff 
sendchmods SCUENTID StmpdifT 
seodrcpfiJes SCUENTID Stmpdifr 
dirlog SCUENTID Stmpdiff 
updiog SCUENTID StmpdifT 

fi 

cp StmpdifT SRJE/SCUENTID.difT 

fl 

fl 

done 

SALUTATION -false 
if SOVERTHRESHOLD; then 
salutation 

cat < <-! 



Some systems have EXCEEDED the nighUy update threshold. Systems widj more 
than STHRESHOLD changes will not be updated except dirougb the express approval 
of the exptools administrator. Sec die rogadm HELP screen 'Approving the 
Fcsendiz^ of update flies to client machines* Co see bow to issue such an 
approval. 

I 

fl 

if SLONGTERMPROB; then 
salutation 
cat <<-! 

Some systems have been over d&reshold for 7 days or more* Please determine 
why these systems have not gotten their updates. 

•»»«»«»».»«««*»»,,*««»»»*#*»»«»,,«»,«^,»^^^.^,,^^^^^,^,^^^^^^^^^^^^^^^^^^^^^ 

! 

fl 

if SMISSINGREPORT; then 
salutation 
cat < <-! 
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Some clients did not send in their nigbtly reports in time to be included in 
today's update processing. Sec tbe rugadm HELP screen "Cbccidng on client 
reports' for tips on how to handle this probtem. 

****«*»•***««***««******»««**«*»**«**«**««***«»**«******«*«*»****«*«*«»»««««« 

I 

11 

if SSUBSCRIBE^ERROR; then 
salutation 
cat < < -! 

Some clients have problems with their subscription lists. Sec the ragadm 

HELP screen 'Understanding RUG ERROR messages' for tips on how to handle this 

problem. 

I 

n 

if not SUSEPUST; then 

> SRiE/UpdaieEnded 

fi 

eiif test -s SNEWFILES: then 

echo "VnSending out newly arrived fiies ..." 
cp SNEWFILES SNEWFOSSCOPY 
{ 

catSEXCLUDEUST 
gcRlinlcdirs SLOCAUD 
} [ mlcsed -w > StmpSignore 
for CUENTID in SCUENTUST; do 

EXPPWD-SUNKDIR/client^UENTID/.pwd 

if test -s SUNKDIR/clicnt/SCUEhrriD/uidiame: then 

aituid » *-uS( < SUNKDIR/cUeni/SCUENTID/uidname)' 
else 
altutd^:' 

n 

CNTplcgme»$RJE/$CUENTID.plcg 
if not plcgrileOK SCNTptcgfile; tben 
if test ! -f SCNTpkgTile; tben 

echo "Xn— > No package file found for SCUENnDXa* 

else 

echo •\n--> Corrupted package file found for SCUENTIDXa' 

n 

else 

echo '\nProcessing SCUENTID *datc** 
> SerrfUe 

if test ! -r StmpSRVtools; then 

mktooUist SSUBSCRUST 1 1 echo 'mlctooUtst $?' >$errfite 
} > StmpSRVtooU 

ft 

if test -s Scrrfile; tben 

emsg 'FaUure preparing server tool list' *$(< SerrfUe)* 
rm-f StmpSRVtools 
exit 2 

n 

if test ! -s StmpSRVtools; then 

echo 'SCMD: ERROR: No tools being served by this server - aborting!' 
exitZ 

fi 
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extractsecuon 1 $C^^^p)cg^tle > Stmppkgnie 
extnctsectton 2 SCNTplcgfile | 

inkscd > StmpCignorc » Cltem-ignored fUcs, scdscr 

tftest! -sStmpptcgfile; tbea 

ecbo "SCMD-EIUtOIL' No CDoisbciog requested by this djeat^ 
continue 

n 

scd -r SiotpCigaort SNEWFILES | 9 Remove ctient-tgDorcd files 
T00LS»SH0MESTO01^a<tm/iq)dl.l/btn/iFrtcgpaa # Get toolnames 
sort-u > StmpCNTmodd 4^ Sort new toolrfUe Ust 



9 Get coois subscribed to 

{ mioooltist StmppkgTile 1 1 echo "mfctoollist S?* >SerTrde :) | 
9 Cstersecc wnb ofTiatd tools 

{ comm -12 - SonpSRVtooto 1 1 echo 'comin %V >Scn1Ue .} | 
$ Put in sorted order 

{sort-u II echo 'sorts?* >$errrtle:) | 

# Join with new toolrfile li« 

{ /uv/btn/jom -t: - Itn^NTmodel j | 

echo 'join S7* > Serrfile ; J | 

# Extract die file names 

{cui^: -f2 II echo "cuts?- >$errfde.} | 

# Put in sorted order 

{sort-o II echo 'sorts?* >Serrrile:} | 

# Put in iqxtate form 

{ sed •$/*/+ &/• II echo'sedS?- >$errftk;} 
) > StmpdifT 

tf test -s Serrfile: dtea 

emsg 'Faihire anstyzing dtent SCUENTID cfacdcsnms* 'S(< Serrfile)' 
continue 

fx 

cc- *wc -I < StmpdifT 
if I -Sec* ^0); dken 

echo '\tNo updates for SCUENTtD* 

else 

echo 'VtChanges for SCUENTID: ' See 
scDdr^files SCUENTID SanpdifT 
updlog SCUENTID StmpdifT 

fi 

cp Stmpdiff SRJE/SCUENTID.difa 

n 

done 

If cmp *s SNEWFILES SNEWFILESCQTV; Ocn 
rmSNEWFILES SNEWBLESCQPY 

else 

comm-l3SNEWFILES SNEWFILESCOPY > Stmpfiks 

mv Stmpfiks SNLWFKLES 

rmSNEWHLESCQPy 

ft 
else 

echo *\nNo reason to send files, none will be sent!' 

fi 

ecbo *\aFim$h 'date' " 

Sdebug cat SoutfUe > > SUNKDlRyservcr/Runlog 
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Claims 

1 . A system for propogating revisions through a communications network, comprising: 

5 status reporting circuitry, associated with a second node of said communications network, for collecting and 

transmitting a current status of second node information stored In a menrxMy of said second node; 

first infonration revising drcurtry, associated witti a first node of said communications network, for receiving 
said current status from sakJ second node, determining as a function of said current status whether a revision 
10 of said second node information is required and, if said revision is required, transmitting said revision to said 

second node to revise said second node information; and 

second information revising circuitry, associated with said second node of said communications networK for 
receiving a cunent status from a third node of said communications networK determining as a function of said 
15 current status from said third node whether a revision of tiiird node information stored in a memory of said thiid 

node is required and, if said revision is required, transmitting said revisfon received from said first node to said 
third rKXte to revise said third node information, said revision theret>y prop^ating through said communica- 
tions network via said first, second and third nodes thereof. 

20 2. The system as recited In Qaim 1 wherein said second information revising circuitry includes memory for storing a 
sut>scrit>er list, said second information revising circuitry transmitting said revisfon as a function of a content of said 
sut>scrfoer list. 

3. The system as recited in Qaim 1 wherein said status reporting drcifltry collects and fransmits said current status 
25 of said second node information to said f rst node at a first time, status information circuitry associated witti said 
third node collecting and transiTutting said currem status from said third 

said second time sut»sequent to said first tinie by a period of time sufficient to allow said second node information 
to t>e folly revised t>efore said second infonnation revising drcuitrytransnf^ noda 

30 4. The system as recited in Claim 1 wherein said second intoriTation revising circuitry is embocfied in a sequence of 
instructions operabfo on a second piDcessor associated wfth said second node; said 

revisions to said sequence of instr u c ti on s ^ thereby atcwing an operation of said second foformation revisnng cir- 
cuitry to be modified. 

35 5. The system as recited in Claim 1 wherein said communications network is hierarchical, said first node fonctioning 
as a server for said second node, said second node functioning as a server tor saki ttitrd noda 

6. The system as recited in Qaim 1 wtierein saki first ffiformation revising circuitry indudes first security drcurtry for 
authenticating said cunrent status received from saki secorxl node t>etore sakJ first node transmits said revisfon to 

40 said second node and said second node includes second security Circuitry for authentica^ 
from said first node before revising said second node infonmation. 

7. The system as recited in Claim 1 wherein saki first intonnation revisirig drcurtry revises saki second rxxie intofma- 
tion by logging on to sakI second nocte and transrrAting a sequence of conmnnan^ 

45 said second node to receive saki revisfon. 

8. A mettKxi of operation of a commun i catfons rtetwork for propagating revisfons through said communications net- 
work, comprising the steps of: 

50 collecting and transmitting a current status of second rKxie information stored in a memory of a secorxl node 

of saki communkations network; 

receiving saki current status from said second node into a first node of saki communications network, saki first 
node determining as a function of saki current status whether a revisfon of saki second node information is 
55 required and. if saki revisfon is required, transmitting saki revisfon to said second node to revise saki second 

node information; arxi 

receiving a current status from a third node of said communications network into saki second node, said sec- 
ond node determining as a function of said current status from said third node whether a revisfon of third node 
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information stored in a memory of said third node is required and. rf said revision is required, transmitting said 
revision received from said first node to said third node to revise said third node information, said revision 
thereby propagating through said communications network via said first, second and third nodes thereof. 

5 9. The method as recited in Claim 8 wherein said step of receiving said current status from said third node corrprises 
the step cf transmitting said revision as a function of a content of a subscrber list stored in said n^emory of said 
second node. 

10. The m^hod as recited in Claim 8 wherein said current status of said second node information is collected and 
10 transmitted to said first node at a first time, said method further comprising the step of collectir>g and transnitting 
said current status from said third node to said second node at a second time, said second time subsequent to said 
first time by a period of time sufficient to allow said second node information to be fully revved before said second 
information revising circuitry transmits said revision to said third node. 

75 11. The method as recited in Claim 8 wherein said second node includes a sequence of instructions operable on a sec- 
ond processor associated with said second node, said revision capable of including revisfons to said sequence of 
instructions, thereby allowing an operation of said second node to be modified. 

12. TTie method as recited in Claim 8 wherein said communications network is hierarchical, said first node functioning 
20 as a server for said second node, saki second node functioning as a server for saki third node. 

13. The method as recited in Claim 8 further cormprising the steps of: 

authenticating said current status received from said second node t>efore saki first node transmits said revisfon 
25 to saki second node; and 

authenticating saki re^nsfon received from saki first node before revising saki second node information. 

14. The method as recited in Claim 8 saki step of receiving saki current status from saki second node into saki first 
30 node comprises the step of retnsing saki second node biformation by to 

ting a sequence Gl commands to sakS second node to ertable said second node to receive 

15. A system for propogating revisions ttirough a hierarchical communications network having a host. afirsHevei node 
arxi a second-level node, comprising: 

35 

Status reporting circuitry, associated with saki first-lei^ node, for collecting 
first-4evel node inforniatfon stored in a rnernory of saki first-l^^ 

first information rinsing ctrcurtry, associated with saki host, for receiving saki current status from saki first-level 
40 rxxie. determining as a function of saki current status wh^her a revisfon of saki first-level node information is 

required and. if saki revisfon is required, transmitting saki reifisfon to saki first-level node to revise saki first- 
level node information; arxi 

second information revising circuftry. associated with saki first-lei^ node, for receiving a cunem status f^ 
4s saki second-level node at a second time, determining as a function of saki current status from saki second- 

level node whether a revision of second-level node information stored in a memory of saki second-level node 
is required and. if saki revisfon is required, transnriitting saki revisk^ 

level node to revise saki second-level node information, saki second time subsequent to saki first time by a 
perfod of time suffkaent to alkw safo first-level node infornriation to be 
50 tion revising circuitry transmits saki revision to saki second-level node, saki revision ttiereby propagating 

through saki communk;ations n^work via saki host, first-level and second-level nodes thereof. 

16. The system as recited in Claim 15 wherein saki second information revising circuitry includes memory for storing 
a subscriber Bst, saki second irrformation revising circuitry transmitting saki re/isfon as a function of a content of 

55 saki subscrfoer list 

17. The system as recited in Claim 15 wherein saki secorxi information revising drcurtry is embodied in a sequerx:e of 
instructions operable on a second processor associated witti saki first-level node, saki revisfon capable of including 
revisfons to saki sequence of instructions. theretDy alkTwing an operation of saki secorxi information revising cir- 
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cuitrytobemodrfied. 

18. The system as recited in Claim 15 wherein said first information revising circuitry includes first security circuitry for 
authenticating said current status received from said first-level node before said host transmits said rension to said 
first-level node and said first-level node includes second security circuitry for authenticating said revision received 
from said host before revising said first-level node information. 

19. The system as recited in Claim 15 wherein said second security circuitry authenticates said revision on a file-by- 
file basis. 

20. The system as recited in Claim 15 wherein said first information revising circuitry revises said first-level node infor- 
mation by fogging on to said first-level node and transmitting a sequence of commands to said f irst-le/el node to 
enable said first-level rxxie to receive said revision. 

21 . A system for propagating revisions through a oomnrunications network, said communicatior^ network including at 
least one first level node, at least one second level node and at least one third level node, said system corrprising: 

status reporting circuitry, associated with said at least one second level node, operative to collect and transmit 
a second level current status of inlbrmation stored in a memory of said at least one second level node; 
first Information revising circuitry, associated with said at least one first level node, operative to: (1) receive said 
second level current status of informatkxi from said at least one second level node, (2) determine, as a function 
of said second level current status of information, whether a revision of said at least one second level node 
information is required, and (3) selectively transmit, in response to said determination, said revision of said at 
least one second level node information to said at least one second level node to revise said at least one sec- 
ond level node infonnation; and 

second infbnmation revising circuitry, associated with said at least one second level node, operative to: (1) 
receive a third level current status of informatkxi from said at least one ttiird level node, (2) determine, as a 
furK:tion of said ttrird level current status, whether a revision of said at least one third level node informatfon 
stored in a memory of saki at least one tNrd level node is required, and selectively transmit in response to 
saki determinatfon. sakI revisfon received from saki at least one first level node to saki at least one tNrd level 
rKXfe to revise saki at least one third level node informatfon. saki reviston thereby propagating through saki 
communicatfons network via saki at le^ one first level, at le^ one second level and at least one third level 
nodes thereof. 
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FIG, 2 
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FIG, 3 
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